home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / pibt3sp1.arc / SREADME.DOC < prev   
Text File  |  1985-10-09  |  7KB  |  196 lines
  1. INTRODUCTION TO PIBTERM v3.0
  2. ============================
  3.  
  4. The four archive libraries
  5.  
  6.      PIBT3SP1.ARC
  7.      PIBT3SP2.ARC
  8.      PIBT3SP3.ARC
  9.      PIBT3SP4.ARC
  10.  
  11. contain TURBO Pascal routines which implement a terminal emulation
  12. and host communications program called PibTerm.
  13.  
  14. This is version 3.0 of Pibterm, released October 7, 1985.
  15.  
  16. Features of PibTerm version 3.0 include:
  17.  
  18.    1.  Several different terminal emulation methods:
  19.  
  20.           -- DEC VT52
  21.           -- DEC VT100 (large subset)
  22.           -- BBS ANSI  (ANSI.SYS color graphics and music)
  23.           -- Dumb glass TTY
  24.           -- Dumb glass TTY in split-screen mode
  25.  
  26.    2.  The ability to act as a host program (mini BBS).
  27.  
  28.    3.  Ring buffered, interrupt driven, serial I/O.
  29.  
  30.    4.  A number of popular file transfer methods:
  31.  
  32.           -- Xmodem Checksum and CRC
  33.           -- Modem7 batch with either Checksum or Crc
  34.           -- Ymodem batch or single file
  35.           -- Telink
  36.           -- Kermit
  37.           -- CompuServe "B" Protocol
  38.           -- Ascii with XON/XOFF
  39.           -- Autodownload Xmodem for Bob Mahoney's EXEC PC BBS.
  40.  
  41.    5.  Telephone dialing directory.
  42.  
  43.    6.  Session logging/capture to printer and/or disk.
  44.  
  45.    7.  On-screen editing (block mode) for use with mainframes.
  46.  
  47.    8.  Menu-driven commands.
  48.  
  49.    9.  Macro-key definition, with sufficient capability to
  50.        provide auto-logon scripts.
  51.  
  52.   10.  Escapes to the operating system (and return from DOS)
  53.        within a PibTerm session.
  54.  
  55.   11.  Built-in file and directory manipulation, including
  56.        directory display, file display, file copying, file erasure.
  57.  
  58.   12.  Screen dumps to a file.
  59.  
  60.   13.  Customizable modem support.
  61.  
  62.   14.  Automatic change of baud rate to the proper one with
  63.        smart modems like the Hayes 1200 and USR Courier.
  64.  
  65.   15.  Built-in phone area code directory.
  66.  
  67.   16.  Review buffer for lines scrolled off top of screen.
  68.  
  69.   17.  Easy alteration of program parameters to customize to
  70.        a particular system.
  71.  
  72.   18.  Extensive script facility for automating communications chores.
  73.  
  74. These archive libraries were created using ARC430.EXE.  I assume
  75. that if you are reading this file, then you have the proper version
  76. of ARC!
  77.  
  78.  
  79. DOCUMENTATION AND EXECUTABLE VERSION
  80. ====================================
  81.  
  82. The files PIBT3SP1.ARC through PIBT3SP4.ARC contain only the source
  83. to PibTerm version 3.0.  The ready-to-use executable version,
  84. complete documentation, and configuration files are available in the
  85. archive files PIBT3EP1.ARC and PIBT3EP2.ARC.
  86.  
  87. CHECKING ARCHIVE'S INTEGRITY
  88. ============================
  89.  
  90. After downloading PIBT3SP1.ARC through PIBT3SP4.ARC, it's a good idea to
  91. verify the integrity of those files using the integrity check
  92. feature of ARC430.  To perform the check, enter:
  93.  
  94.      ARC430 T PIBT3SP1.ARC
  95.      ARC430 T PIBT3SP2.ARC
  96.      ARC430 T PIBT3SP3.ARC
  97.      ARC430 T PIBT3SP4.ARC
  98.  
  99. If the archives pass the integrity check, then you can proceed
  100. to extract the files as shown below.  If an archive is bad, you
  101. can either try downloading it again (although the file may be
  102. bad on the BBS you called), or write me for the source + executables
  103. disks as described below.
  104.  
  105.  
  106. COMPILING PIBTERM
  107. =================
  108.  
  109. First of all, you need about 2 megs of disk space to compile PibTerm.
  110. You will also need Turbo Pascal version 3.0 or later.
  111.  
  112. To compile PibTerm, extract all the .PAS files from the archive
  113. files.  You do this by saying:
  114.  
  115.      ARC430 E PIBT3SP1.ARC *.*
  116.      ARC430 E PIBT3SP2.ARC *.*
  117.      ARC430 E PIBT3SP3.ARC *.*
  118.      ARC430 E PIBT3SP4.ARC *.*
  119.  
  120. Enter Turbo by issuing the TURBO command to DOS.
  121.  
  122. Next, enter O for O)ptions and set Turbo to write a .COM file
  123. by entering a C.  Also set the maximum heap space using A to
  124. 2000H.  This is necessary to ensure that the escape to DOS
  125. function will find enough room to load a secondary command
  126. processor.  You MAY be able to run some PibTerm functions with
  127. a smaller maximum heap size; this may be useful if you have only
  128. a 256K or smaller machine.  Exit from the O)ptions and use
  129. M to set the Main program to be the file PIBTERM.PAS. Type C
  130. to start the compile.  On a 4.77 8088-based machine, the compilation
  131. takes about seventeen minutes.
  132.  
  133. You should end up with nine files:
  134.  
  135.    PIBTERM.COM
  136.    PIBTERM.000
  137.    PIBTERM.001
  138.    PIBTERM.002
  139.    PIBTERM.003
  140.    PIBTERM.004
  141.    PIBTERM.005
  142.    PIBTERM.006
  143.    PIBTERM.007
  144.  
  145. To run PibTerm, just enter PIBTERM at the DOS prompt.  You will
  146. be prompted for the creation of a number of necessary configuration
  147. files, unless you use the sample configuration files provided in the
  148. executable version's archive.
  149.  
  150. The various routines for menu construction, file handle I/O,
  151. asynchronous communication, etc. are of use in themselves.  Hopefully
  152. in 34000+ lines of Turbo code, you'll find SOMETHING useful!
  153.  
  154.  
  155. RESTRICTIONS ON USE
  156. ===================
  157.  
  158. You may also make unlimited copies of the program and distribute these
  159. copies as you desire, except that I, Philip R. Burns, reserve the sole right
  160. to distribute the program for profit.  You may request a duplication
  161. charge, not to exceed $12 per copy for the complete source archive
  162. (assuming you need to have two disks to hold the four archive files).
  163.  
  164. You should distribute the program without any changes you have made,
  165. and then a SEPARATE version with any changes you've made.
  166. You should clearly mark the changes in some sort of documentation file,
  167. as well as in the source files you change.  I also suggest that you
  168. add a line to the initial output of PibTerm indicating your name and
  169. the date of your modification.
  170.  
  171. You may use the source code and modify it as you please for
  172. NON-COMMERCIAL APPLICATIONS ONLY.  You may NOT use the code in
  173. developing commercial applications without my permission.
  174.  
  175. I encourage you to extend this program and add interesting
  176. new features.  I also encourage you to upload these changes to
  177. your local BBSs in order to share your work with others.  What I
  178. do NOT want is for you to rip off this code as if it were yours
  179. and sell it for a profit.  That's not nice.
  180.  
  181.  
  182. ADDRESSES FOR ELECTRONIC LETTER BOMBS
  183. =====================================
  184.  
  185. You may leave me messages on the following BBSs:
  186.  
  187.       Gene Plantz's BBS (312) 882 4145
  188.       Ron Fox's BBS     (312) 940 6496
  189.  
  190. Gene's BBS is registration only ($15 a year) and well worth it.
  191. Ron's BBS is essentially open, and also worth calling.
  192.  
  193. Thanks,
  194. Phil Burns
  195. October, 1985
  196.